Port DIAGNOSTICS - KWP2000-CAN

TOSUN-HW access to KWP2000 via CAN. Component of the Add-on ecu.test diagnostics

Stimulation

此端口不具备激励能力。

Name

在以下情况下可用

默认值

有效值

Type

Description

Channel number

‘1’

string

当存在多个同类型控制器时,用于选择通道号。

Bit rate

‘500KB’

[‘10KB’, ‘20KB’, ‘50KB’, ‘83.333KB’, ‘100KB’, ‘125KB’, ‘250KB’, ‘500KB’, ‘666.667KB’, ‘800KB’, ‘1000KB’]

string

Bit rate

Activate terminating resistor

☐

bool

激活内部 120 Ω 终端电阻

Mode

Standard

[Standard, Extended, All]

string

寻址模式(Standard = 11bit,Extended = 29bit)

接收错误帧

☐

bool

接收错误帧

Transmission confirmation

☐

bool

启用确认式发送。Bus-Write test step 和 Send 工具作业会阻塞,直到报文成功传输到总线上或确认超时到期。

传输确认的超时时间

1000

int

消息必须在此时间段(毫秒)内成功发送。否则会产生错误。(不得大于 64535ms)。仅在主动确认模式下使用。

CallService

执行诊断服务请求。

示例:要调用 UDS 服务 Read Data by Identifier(SID=0x22,DID=0xACDC),Request 为 ByteStream(“22 AC DC”)

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Request

ByteStream

要发送的诊断服务请求(ByteStream)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - :

ClearDTCs

ClearDiagnosticInformation (0x14):客户端用于清除服务器内存中的诊断信息。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

GroupOfDTC

0xFF00

int

要清除的 DTC 组编号(默认:0xFF00 = 所有 DTC,可选)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

CloseSession

关闭诊断会话。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

ECUReset

ECUReset (0x11):请求服务器根据 ResetMode 参数值的内容实际执行 ECU 复位。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

ResetMode

int

复位模式(可选)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

InputOutputControlByCommonIdentifier

InputOutputControlByCommonIdentifier (0x2F):客户端用于为服务器的 InputOutputCommonIdentifier 所引用的输入信号、ECU 内部功能和/或电子系统的控制输出(执行器)替换值。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

ControlOption

ByteStream

描述服务器必须如何控制其输入和输出 - ByteStream(可选)

DataIdentifierHighByte

int

数据的标识符(高字节)

DataIdentifierLowByte

int

数据的标识符(低字节)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

InputOutputControlByLocalIdentifier

InputOutputControlByLocalIdentifier (0x30):客户端用于替代输入信号的值、替换 ECU 内部功能,和/或控制由服务器 InputOutputLocalIdentifier 引用的电子系统的输出(执行器)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

ControlOption

ByteStream

描述服务器必须如何控制其输入和输出 - ByteStream(可选)

DataIdentifier

int

Identifier

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

OpenDiagSession

打开使用 ISO-TP 的 KWP2000 诊断会话。如果已存在具有指定参数的会话,则返回现有会话的句柄,而不会打开新会话。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

AddressByte

ByteStream

网络目标地址或地址扩展(仅与扩展寻址或混合寻址相关) - 长度为 1 的 ByteStream

AddressMode

0

int

寻址模式代码 - 整数(0:标准寻址 | 1:扩展寻址)

BlockSize

0

int

可连续接收而无需中间流控的帧数(0 - 255) - Integer

DiagTimeoutCanIsoTp

2000

int

通过 ISO-TP 协议等待诊断请求响应时的超时时间,单位为毫秒 - 整数

FillByte

ByteStream

用于填充报文的字节(可选) - 长度为 1 的 ByteStream

FlowControlAddressByte

ByteStream

FlowControl 使用不同的网络目标地址或地址扩展(仅与扩展寻址和混合寻址相关)- 长度为 1 的 ByteStream

FlowControlId

int

流控消息的消息 ID(可选)- 十六进制(可选整数)

IsExtended

-1

int

是否使用扩展 CAN-ID 格式?(1=是 / 29 位;0=否 / 11 位;-1 = 使用 TBC 中的设置)

IsExtendedFlowControlId

-1

int

是否使用扩展 CAN ID 格式(用于 FlowControlId)?(1=是/29 位;0=否/11 位;-1 = 使用与 IsExtended 相同的设置)

IsExtendedRequestId

-1

int

是否对 RequestId 使用扩展 CAN ID 格式?(1=是/29 位;0=否/11 位;-1 = 使用与 IsExtended 相同的设置)

IsExtendedResponseId

-1

int

是否对 ResponseId 使用扩展 CAN ID 格式?(1=是/29 位;0=否/11 位;-1 = 使用与 IsExtended 相同的设置)

RequestId

int

ECU 请求的报文 ID - 十六进制(可选,整数)

ResponseId

int

ECU 响应的消息 ID - 十六进制(可选 Integer)

SeparationTime

0

int

连续片段之间的最小时间间隔 0x00..0x7F => 0..127ms,0x80..0xf0 => 保留,0xf1..0xf9 => 100.900µs,0xfa..0xff => 保留 - 整数

StartRequest

ByteStream

用于打开会话的诊断请求(可选) - ByteStream

StopRequest

ByteStream

用于结束会话的诊断请求(可选) - ByteStream

TesterPresentCycleTime

int

周期性 tester-available 信令的周期长度(ms,可选)- Integer

TesterPresentRequest

ByteStream

用于周期性 tester-available 信号的诊断请求(可选)- ByteStream

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionHandle

int

诊断会话的句柄

OpenTcfDiagSession

打开在 TCF 中配置的诊断会话。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SUT

object

诊断会话的句柄。可以是 TCF 中指定的 SUT 名称,或 None。仅当只指定了一个 SUT 时才能使用 None。

ReadDataByCommonIdentifier

ReadDataByCommonIdentifier (0x22):请求由公共 RecordCommonIdentifier 标识的服务器的数据记录值。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DataIdentifierHighByte

int

数据的标识符(高字节)

DataIdentifierLowByte

int

数据的标识符(低字节)

MaximumNumberOfResponsesToSend

int

指示最大响应数量(可选)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

TransmissionMode

int

传输模式的指示(可选)

0x01 = single,

0x02 = slow,

0x03 = medium,

0x04 = fast,

0x05 = 停止(停止 0x02-0x04 的数据传输)

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

ReadDataByLocalIdentifier

ReadDataByLocalIdentifier (0x21):请求服务器中由 RecordLocalIdentifier 标识的数据记录值。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DataIdentifier

int

Identifier

MaximumNumberOfResponsesToSend

int

指示响应的最大数量

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

TransmissionMode

int

指示传输模式

0x01 = single,

0x02 = slow,

0x03 = medium,

0x04 = fast,

0x05 = 停止(停止 0x02-0x04 的数据传输)

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

ReadDiagnosticTroubleCodes

ReadDiagnosticTroubleCodes (0x13):客户端用它从服务器内存中读取诊断故障码。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

GroupOfDTC

0xFF00

int

DTC 组的编号(默认:0xFF00 = 所有 DTC)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

ReadDiagnosticTroubleCodesByStatus

ReadDiagnosticTroubleCodesByStatus (0x18):客户端用它按状态从服务器内存中读取诊断故障码。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

GroupOfDTC

0xFF00

int

DTC 组的编号(默认:0xFF00 = 所有 DTC)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

StatusOfDTC

0x00

int

DTC 的状态

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

ReadECUIdentification

ReadECUIdentification (0x1A):从服务器请求标识数据。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

IdentificationOption

int

标识数据的描述(可选)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

ReadStatusOfDiagnosticTroubleCodes

ReadStatusOfDiagnosticTroubleCodes (0x17):客户端用于从服务器内存中读取诊断故障码及其关联状态。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

GroupOfDTC

0xFF00

int

DTC 组的编号(默认:0xFF00 = 所有 DTC)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

RequestRoutineByLocalIdentifier

RequestRoutineResultsByLocalIdentifier (0x33):客户端用它请求由 RoutineLocalIdentifier 引用、并由在服务器内存中执行的例程生成的结果(例如退出状态信息)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

RoutineId

int

例程的 ID

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

SecurityAccessRequestSeed

SecurityAccess (0x27) requestSeed:请求具有车辆制造商所定义安全级别的种子。此外还可以指定一个 Seed&Key 库,用于计算与所获种子对应的密钥。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Options

object

要传递给 Seed&Key 库的选项字符串(可选 - str)。如果 Options 为 None,则调用库函数 GenerateKeyEx()。如果 Options 是字符串,则调用库函数 GenerateKeyExOpt(),即使是空字符串也是如此。

SecurityAccessDataRecord

ByteStream

请求 seed 信息时额外传输的数据(可选)。ByteStream

SecurityLevel

int

要解锁的安全级别,0x01 与 0x7D 之间的奇数

SeedAndKeyLibraryPath

string

用于计算与所获得种子对应的密钥的 Seed&Key 库路径(可选)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

Variant

string

要传递给 Seed&Key 库的 ECU 变体限定符(可选)

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - SecurityAccessDiagResult - 或 NegativeResponse

SecurityAccessSendKey

SecurityAccess (0x27) sendKey:发送带有车辆制造商定义的安全等级的密钥。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SecurityKey

ByteStream

用于解锁所需安全级别的密钥。如果 SecurityAccessRequestSeed Job 使用了 Seed&Key 库,则计算出的密钥会在 SecurityAccessRequestSeed Job 的结果中返回。否则必须事先根据 SecurityAccessRequestSeed Job 结果中返回的 seed 计算出密钥。ByteStream

SecurityLevel

int

要解锁的安全级别,0x02 到 0x7E 之间的偶数(= SecurityAccessRequestSeed 的 SecurityLevel + 1)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

SetTesterPresent

更改测试配置中为周期性发送的 TesterPresent 报文指定的参数。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

TesterPresentCycleTime

int

周期性发送请求的周期长度(ms)。若将周期长度指定为 0,则停用周期性发送

TesterPresentRequest

ByteStream()

ByteStream

循环发送的报文的数据载荷

StartRoutineByLocalIdentifier

StartRoutineByLocalIdentifier (0x31):客户端用于在服务器的内存中启动例程。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

RoutineEntryOption

int

作为 ByteStream 的例程参数(可选)

RoutineId

int

例程的 ID

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

StopRoutineByLocalIdentifier

StopRoutineByLocalIdentifier (0x32):客户端用于停止服务器内存中由 RoutineLocalIdentifier 引用的例程。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

RoutineExitOption

int

作为 ByteStream 的例程参数(可选)

RoutineId

int

例程的 ID

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

WriteDataByCommonIdentifier

WriteDataByCommonIdentifier (0x2E):客户端用它通过单条请求报文向多个服务器写入 RecordValues(数据值)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DataIdentifierHighByte

int

数据的标识符(高字节)

DataIdentifierLowByte

int

数据的标识符(低字节)

RecordValue

ByteStream

要写入的数据 - ByteStream

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

WriteDataByLocalIdentifier

WriteDataByLocalIdentifier (0x3B):客户端用于向服务器写入 RecordValues(数据值)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DataIdentifier

int

Identifier

RecordValue

ByteStream

要写入的数据 - ByteStream

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse